'use strict'
//模板版本:1.3.1
//见http://vuejs-templates.github.io/webpack文档。
const path = require('path')

module.exports = {
  dev: {

    // 编译输出的二级目录
    assetsSubDirectory: 'static',
    // 编译发布的根目录，可配置为资源服务器域名或者cdn域名
    assetsPublicPath: '/',
    // 需要使用proxyTable代理的接口(可以跨域)
    proxyTable: {},

    // 各种开发服务器设置
    host: 'localhost', // 可以被process.env.HOST覆盖吗
    port: 8080, //可以被process.env覆盖。端口，如果端口正在使用，将确定一个空闲端口
    autoOpenBrowser: true, //自动打开浏览器
    errorOverlay: true,//  在浏览器是否展示错误蒙层
    notifyOnErrors: true, // 是否展示错误的通知
    // 这个是webpack-dev-servr的watchOptions的一个选项，指定webpack检查文件的方式
    // 因为webpack使用文件系统去获取文件改变的通知。在有些情况下，这个可能不起作用。例如，当使用NFC的时候，
    // vagrant也会在这方面存在很多问题，在这些情况下，使用poll选项（以轮询的方式去检查文件是否改变）可以设定为true
    // 或者具体的数值，指定文件查询的具体周期。
    poll: false, // https://webpack.js.org/configuration/dev-server/#devserver-watchoptions-

    // 使用Eslint装载机吗?
    // 如果为真，您的代码将在绑定和
    // 在控制台中会显示linting错误和警告。
    useEslint: true, // 是否使用eslint loader去检查代码
   
    //如果为真，则eslint错误和警告也将显示在错误覆盖中在浏览器中。
    showEslintErrorsInOverlay: false,

    /**
     * Source Maps 源地图
     */

    // https://webpack.js.org/configuration/devtool/#development
    devtool: 'cheap-module-eval-source-map',

    //如果在devtools中调试vue文件有问题，
    //将这个设置为false——它*可能*有帮助
    // https://vue-loader.vuejs.org/en/options.html#cachebusting
    cacheBusting: true, // 指定是否通过在文件名称后面添加一个查询字符串来创建source map的缓存
    // 关闭css的source map
    cssSourceMap: true
  },

  build: {
    // Template for index.html
    //index.html的模板
    index: path.resolve(__dirname, '../dist/index.html'),

    // Paths
    assetsRoot: path.resolve(__dirname, '../dist'),
    assetsSubDirectory: 'static',
    assetsPublicPath: '/',

    /**
     * Source Maps 源地图
     */

    productionSourceMap: true,
    // https://webpack.js.org/configuration/devtool/#production
    devtool: '#source-map',

    // Gzip在默认情况下关闭许多流行的静态主机，比如
    // Surge或Netlify已经为您压缩了所有静态资产。
    //在设置为“true”之前，请确保:
    // npm install——save-dev compression-webpack-plugin
    productionGzip: false, // 是否开启生产环境的gzip压缩
    productionGzipExtensions: ['js', 'css'], // 开启gzip压缩的文件的后缀名称

    //运行build命令，附加一个参数to
    //构建完成后查看bundle analyzer报告:
    //“npm运行构建——报告”
    //设置为“true”或“false”，总是打开或关闭它
    bundleAnalyzerReport: process.env.npm_config_report
    // 如果这个选项是true的话，那么则会在build后，会在浏览器中生成一份bundler报告
  }
}
